Node / meshtastic / Meshtastic-Android / files / core / data / src / commonTest / kotlin / org / meshtastic / core / data / repository / DeviceLinkMatcherTest.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.data.repository

Tff7b72import T7ee787org.meshtastic.core.model.DeviceLink

Tff7b72import T7ee787kotlin.test.Test

Tff7b72import T7ee787kotlin.test.assertEquals

Tff7b72import T7ee787kotlin.test.assertFalse

Tff7b72import T7ee787kotlin.test.assertNull

Tff7b72import T7ee787kotlin.test.assertTrue

T8b949e/**

* Tests for [DeviceLinkMatcher], grounded in the acceptance scenarios of the Meshtastic-Apple `010-device-mshto-links`

* spec. Mirrors the as-built `DeviceLinksSection` matching (platformioTarget, not hwModelSlug).

*/

Tff7b72class T56d364DeviceLinkMatcherTest Tb4b4b4{

Tff7b72private Tff7b72val Te6edf3marketplaceKeys Tff7b72= Te6edf3setOfTb4b4b4(Ta5d6ff"Ta5d6ffroklandTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffhexaspotTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffaliexpressTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffamazonTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6fftindieTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffmuziTa5d6ff"Tb4b4b4)

Tff7b72private Tff7b72val Te6edf3deviceTargets Tff7b72=

Te6edf3setOfTb4b4b4(Ta5d6ff"Ta5d6ffrak4631Ta5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffheltec-v3Ta5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffseeed_solar_nodeTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6fftbeamTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffrak4631_nomadstar_meteor_proTa5d6ff"Tb4b4b4)

Tff7b72private Tff7b72fun Td2a8fflinkTb4b4b4(Te6edf3shortCodeTb4b4b4: Tffa657StringTb4b4b4, Te6edf3isVendorTb4b4b4: Tffa657Boolean Tff7b72= Tff7b72falseTb4b4b4, Te6edf3regionsTb4b4b4: Te6edf3ListTff7b72<Tffa657StringTff7b72>Tff7b72? Tff7b72= Tff7b72nullTb4b4b4) Tff7b72= Te6edf3DeviceLinkTb4b4b4(

Te6edf3shortCode Tff7b72= Te6edf3shortCodeTb4b4b4,

Te6edf3originalUrl Tff7b72= Ta5d6ff"Ta5d6ffhttps://example.com/Tffd700$Te6edf3shortCodeTa5d6ff"Tb4b4b4,

Te6edf3isVendor Tff7b72= Te6edf3isVendorTb4b4b4,

Te6edf3regions Tff7b72= Te6edf3regionsTb4b4b4,

Tb4b4b4)

Tff7b72private Tff7b72fun Td2a8ffmatchTb4b4b4(Te6edf3linksTb4b4b4: Te6edf3ListTff7b72<Te6edf3DeviceLinkTff7b72>Tb4b4b4, Te6edf3targetTb4b4b4: Tffa657StringTb4b4b4, Te6edf3regionTb4b4b4: Tffa657String Tff7b72= Ta5d6ff"Ta5d6ffUSTa5d6ff"Tb4b4b4) Tff7b72=

Te6edf3DeviceLinkMatcherTb4b4b4.Te6edf3matchTb4b4b4(Te6edf3linksTb4b4b4, Te6edf3marketplaceKeysTb4b4b4, Te6edf3deviceTargetsTb4b4b4, Te6edf3targetTb4b4b4, Te6edf3regionTb4b4b4)Tb4b4b4.Te6edf3map Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3shortCode Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffexactVendorMatchIsIncludedTb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3result Tff7b72= Te6edf3matchTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3linkTb4b4b4(Ta5d6ff"Ta5d6ffheltec-v3Ta5d6ff"Tb4b4b4, Te6edf3isVendor Tff7b72= Tff7b72trueTb4b4b4)Tb4b4b4)Tb4b4b4, Te6edf3target Tff7b72= Ta5d6ff"Ta5d6ffheltec-v3Ta5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Ta5d6ff"Ta5d6ffheltec-v3Ta5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3resultTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffforeignVendorLinkIsExcludedTb4b4b4(Tb4b4b4) Tb4b4b4{

T8b949e// Scenario 5: rak4631_nomadstar_meteor_pro (a different device's target) must NOT show for rak4631.

Tff7b72val Te6edf3result Tff7b72=

Te6edf3matchTb4b4b4(

Te6edf3listOfTb4b4b4(Te6edf3linkTb4b4b4(Ta5d6ff"Ta5d6ffrak4631Ta5d6ff"Tb4b4b4, Te6edf3isVendor Tff7b72= Tff7b72trueTb4b4b4)Tb4b4b4, Te6edf3linkTb4b4b4(Ta5d6ff"Ta5d6ffrak4631_nomadstar_meteor_proTa5d6ff"Tb4b4b4, Te6edf3isVendor Tff7b72= Tff7b72trueTb4b4b4)Tb4b4b4)Tb4b4b4,

Te6edf3target Tff7b72= Ta5d6ff"Ta5d6ffrak4631Ta5d6ff"Tb4b4b4,

Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Ta5d6ff"Ta5d6ffrak4631Ta5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3resultTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffproductVariantIsIncludedAndProminentTb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3result Tff7b72= Te6edf3matchTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3linkTb4b4b4(Ta5d6ff"Ta5d6ffrak4631_epaperTa5d6ff"Tb4b4b4)Tb4b4b4)Tb4b4b4, Te6edf3target Tff7b72= Ta5d6ff"Ta5d6ffrak4631Ta5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Ta5d6ff"Ta5d6ffrak4631_epaperTa5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3resultTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffmarketplaceLinkIsRegionFilteredTb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3links Tff7b72= Te6edf3listOfTb4b4b4(Te6edf3linkTb4b4b4(Ta5d6ff"Ta5d6ffrokland-rak4631Ta5d6ff"Tb4b4b4, Te6edf3regions Tff7b72= Te6edf3listOfTb4b4b4(Ta5d6ff"Ta5d6ffUSTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffCATa5d6ff"Tb4b4b4)Tb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Ta5d6ff"Ta5d6ffrokland-rak4631Ta5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3matchTb4b4b4(Te6edf3linksTb4b4b4, Te6edf3target Tff7b72= Ta5d6ff"Ta5d6ffrak4631Ta5d6ff"Tb4b4b4, Te6edf3region Tff7b72= Ta5d6ff"Ta5d6ffUSTa5d6ff"Tb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3emptyListTb4b4b4(Tb4b4b4)Tb4b4b4, Te6edf3matchTb4b4b4(Te6edf3linksTb4b4b4, Te6edf3target Tff7b72= Ta5d6ff"Ta5d6ffrak4631Ta5d6ff"Tb4b4b4, Te6edf3region Tff7b72= Ta5d6ff"Ta5d6ffDETa5d6ff"Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffrakPrefixIsStrippedForMarketplaceVariantMatchTb4b4b4(Tb4b4b4) Tb4b4b4{

T8b949e// "rokland-4631" should match device "rak4631" via the rak-stripped variant "4631".

Tff7b72val Te6edf3result Tff7b72= Te6edf3matchTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3linkTb4b4b4(Ta5d6ff"Ta5d6ffrokland-4631Ta5d6ff"Tb4b4b4, Te6edf3regions Tff7b72= Te6edf3listOfTb4b4b4(Ta5d6ff"Ta5d6ffUSTa5d6ff"Tb4b4b4)Tb4b4b4)Tb4b4b4)Tb4b4b4, Te6edf3target Tff7b72= Ta5d6ff"Ta5d6ffrak4631Ta5d6ff"Tb4b4b4, Te6edf3region Tff7b72= Ta5d6ff"Ta5d6ffUSTa5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Ta5d6ff"Ta5d6ffrokland-4631Ta5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3resultTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffworldwideMarketplaceShowsRegardlessOfRegionTb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3links Tff7b72= Te6edf3listOfTb4b4b4(Te6edf3linkTb4b4b4(Ta5d6ff"Ta5d6ffrak4631_aliexpressTa5d6ff"Tb4b4b4, Te6edf3regions Tff7b72= Te6edf3emptyListTb4b4b4(Tb4b4b4)Tb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Ta5d6ff"Ta5d6ffrak4631_aliexpressTa5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3matchTb4b4b4(Te6edf3linksTb4b4b4, Te6edf3target Tff7b72= Ta5d6ff"Ta5d6ffrak4631Ta5d6ff"Tb4b4b4, Te6edf3region Tff7b72= Ta5d6ff"Ta5d6ffZZTa5d6ff"Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffunrelatedLinksProduceEmptyResultTb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3links Tff7b72=

Te6edf3listOfTb4b4b4(

Te6edf3linkTb4b4b4(Ta5d6ff"Ta5d6ffgithubTa5d6ff"Tb4b4b4)Tb4b4b4,

Te6edf3linkTb4b4b4(Ta5d6ff"Ta5d6ffheltec-v3Ta5d6ff"Tb4b4b4, Te6edf3isVendor Tff7b72= Tff7b72trueTb4b4b4)Tb4b4b4,

Te6edf3linkTb4b4b4(Ta5d6ff"Ta5d6ffrokland-heltec-v3Ta5d6ff"Tb4b4b4, Te6edf3regions Tff7b72= Te6edf3listOfTb4b4b4(Ta5d6ff"Ta5d6ffUSTa5d6ff"Tb4b4b4)Tb4b4b4)Tb4b4b4,

Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3emptyListTb4b4b4(Tb4b4b4)Tb4b4b4, Te6edf3matchTb4b4b4(Te6edf3linksTb4b4b4, Te6edf3target Tff7b72= Ta5d6ff"Ta5d6fftbeamTa5d6ff"Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffanotherDevicesTargetIsNotMatchedAsVariantTb4b4b4(Tb4b4b4) Tb4b4b4{

T8b949e// "rak4631_nomadstar_meteor_pro" prefix-matches "rak4631_" but is itself a device target → excluded.

Tff7b72val Te6edf3result Tff7b72= Te6edf3matchTb4b4b4(Te6edf3listOfTb4b4b4(Te6edf3linkTb4b4b4(Ta5d6ff"Ta5d6ffrak4631_nomadstar_meteor_proTa5d6ff"Tb4b4b4)Tb4b4b4)Tb4b4b4, Te6edf3target Tff7b72= Ta5d6ff"Ta5d6ffrak4631Ta5d6ff"Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3emptyListTb4b4b4(Tb4b4b4)Tb4b4b4, Te6edf3resultTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffvendorAndVariantSortBeforeMarketplaceTb4b4b4(Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3links Tff7b72=

Te6edf3listOfTb4b4b4(

Te6edf3linkTb4b4b4(Ta5d6ff"Ta5d6ffrak4631_aliexpressTa5d6ff"Tb4b4b4, Te6edf3regions Tff7b72= Te6edf3emptyListTb4b4b4(Tb4b4b4)Tb4b4b4)Tb4b4b4,

Te6edf3linkTb4b4b4(Ta5d6ff"Ta5d6ffrak4631Ta5d6ff"Tb4b4b4, Te6edf3isVendor Tff7b72= Tff7b72trueTb4b4b4)Tb4b4b4,

Te6edf3linkTb4b4b4(Ta5d6ff"Ta5d6ffrokland-rak4631Ta5d6ff"Tb4b4b4, Te6edf3regions Tff7b72= Te6edf3listOfTb4b4b4(Ta5d6ff"Ta5d6ffUSTa5d6ff"Tb4b4b4)Tb4b4b4)Tb4b4b4,

Te6edf3linkTb4b4b4(Ta5d6ff"Ta5d6ffrak4631_epaperTa5d6ff"Tb4b4b4)Tb4b4b4,

Tb4b4b4)

Tff7b72val Te6edf3result Tff7b72= Te6edf3matchTb4b4b4(Te6edf3linksTb4b4b4, Te6edf3target Tff7b72= Ta5d6ff"Ta5d6ffrak4631Ta5d6ff"Tb4b4b4, Te6edf3region Tff7b72= Ta5d6ff"Ta5d6ffUSTa5d6ff"Tb4b4b4)

T8b949e// Vendor + variant first (order among them preserved from input), marketplace links after.

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Ta5d6ff"Ta5d6ffrak4631Ta5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffrak4631_epaperTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffrak4631_aliexpressTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffrokland-rak4631Ta5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3resultTb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffbuildTargetVariantsStripsRakPrefixTb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Ta5d6ff"Ta5d6ffrak4631Ta5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ff4631Ta5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3DeviceLinkMatcherTb4b4b4.Te6edf3buildTargetVariantsTb4b4b4(Ta5d6ff"Ta5d6ffrak4631Ta5d6ff"Tb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Ta5d6ff"Ta5d6ffheltec-v3Ta5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3DeviceLinkMatcherTb4b4b4.Te6edf3buildTargetVariantsTb4b4b4(Ta5d6ff"Ta5d6ffheltec-v3Ta5d6ff"Tb4b4b4)Tb4b4b4)

T8b949e// Bare "rak" strips to empty and is not added.

Te6edf3assertEqualsTb4b4b4(Te6edf3listOfTb4b4b4(Ta5d6ff"Ta5d6ffrakTa5d6ff"Tb4b4b4)Tb4b4b4, Te6edf3DeviceLinkMatcherTb4b4b4.Te6edf3buildTargetVariantsTb4b4b4(Ta5d6ff"Ta5d6ffrakTa5d6ff"Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffisMarketplaceLinkDetectsPrefixAndSuffixTb4b4b4(Tb4b4b4) Tb4b4b4{

Te6edf3assertTrueTb4b4b4(Te6edf3DeviceLinkMatcherTb4b4b4.Te6edf3isMarketplaceLinkTb4b4b4(Ta5d6ff"Ta5d6ffrokland-rak4631Ta5d6ff"Tb4b4b4, Te6edf3marketplaceKeysTb4b4b4)Tb4b4b4)

Te6edf3assertTrueTb4b4b4(Te6edf3DeviceLinkMatcherTb4b4b4.Te6edf3isMarketplaceLinkTb4b4b4(Ta5d6ff"Ta5d6ffheltec-v3_aliexpressTa5d6ff"Tb4b4b4, Te6edf3marketplaceKeysTb4b4b4)Tb4b4b4)

Te6edf3assertFalseTb4b4b4(Te6edf3DeviceLinkMatcherTb4b4b4.Te6edf3isMarketplaceLinkTb4b4b4(Ta5d6ff"Ta5d6ffheltec-v3Ta5d6ff"Tb4b4b4, Te6edf3marketplaceKeysTb4b4b4)Tb4b4b4)

Tb4b4b4}

Tf0883e@Test

Tff7b72fun Td2a8ffmarketplaceKeyForUsesDelimiterBoundsTb4b4b4(Tb4b4b4) Tb4b4b4{

T8b949e// Both prefix and suffix forms resolve to their marketplace...

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ffroklandTa5d6ff"Tb4b4b4, Te6edf3DeviceLinkMatcherTb4b4b4.Te6edf3marketplaceKeyForTb4b4b4(Ta5d6ff"Ta5d6ffrokland-rak4631Ta5d6ff"Tb4b4b4, Te6edf3marketplaceKeysTb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ffaliexpressTa5d6ff"Tb4b4b4, Te6edf3DeviceLinkMatcherTb4b4b4.Te6edf3marketplaceKeyForTb4b4b4(Ta5d6ff"Ta5d6ffaliexpress-rak1921Ta5d6ff"Tb4b4b4, Te6edf3marketplaceKeysTb4b4b4)Tb4b4b4)

Te6edf3assertEqualsTb4b4b4(Ta5d6ff"Ta5d6ffaliexpressTa5d6ff"Tb4b4b4, Te6edf3DeviceLinkMatcherTb4b4b4.Te6edf3marketplaceKeyForTb4b4b4(Ta5d6ff"Ta5d6ffrak4631_aliexpressTa5d6ff"Tb4b4b4, Te6edf3marketplaceKeysTb4b4b4)Tb4b4b4)

T8b949e// ...but a code that merely begins with a marketplace name is NOT that marketplace.

Te6edf3assertNullTb4b4b4(Te6edf3DeviceLinkMatcherTb4b4b4.Te6edf3marketplaceKeyForTb4b4b4(Ta5d6ff"Ta5d6ffmuziworksTa5d6ff"Tb4b4b4, Te6edf3marketplaceKeysTb4b4b4)Tb4b4b4)

Te6edf3assertNullTb4b4b4(Te6edf3DeviceLinkMatcherTb4b4b4.Te6edf3marketplaceKeyForTb4b4b4(Ta5d6ff"Ta5d6ffheltec-v3Ta5d6ff"Tb4b4b4, Te6edf3marketplaceKeysTb4b4b4)Tb4b4b4)

Tb4b4b4}

Tb4b4b4}